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SECTION I 
INTRODUCTION 


This paper sketches the principal features of the PHOENIX time- 


sharing supervisor called Monitor 1, from a user's point of view. 


At the time of this writing, Monitor 1 is in the early stages of 
debugging. Consequently the material in this document is subject to 


change. 


SECTION II 
MONITOR 1 


THE USER AT THE TYPEWRITER 


When the user first sits down at the typewriter, the program to which 
he talks is ALTAR. He need not be aware that he is communicating to a 
definite program which is handled by the Monitor proper like any other user 
program: he may think that he is speaking to the system. It is, however, 


convenient to keep ALTAR and the Monitor separate. 


ALTAR consists of a single file which can be run as a program for 
several different users at once (i.e. time-shared), having a distinct set 
of live registers for each user (see THE USER PROGRAM'S VIEW OF 
MONITOR). 


A file is an ordered string of 25 bit PHOENIX words whose length is 
a multiple of 4K* words. Each file has a name, ** which is unique for the 
particular user. A file generally belongs to one and only one user. How- 


ever, there will be system files to which any user may have access. 


The typewriter with which the user communicates with ALTAR is 
called the command typewriter. He may not switch typewriters in the mid- 
dle of running, except possibly under direction of a system command type- 
writer. A system programmer can log into the system by using a special 
code, causing his typewriter to become a system command typewriter and 
having certain special capabilities not discussed in this report. 

*K = 1024 
** A name is either a string of letters and digits containing at least one let- 
ter, or a string of characters, the first of which is a left quote, the last 


of which is a right quote, which contains no other right quotes. 
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ALTAR COMMANDS 


Following is a list of primitive ALTAR commands. The actual user 


commands will be combinations of these primitive ones. 


login projectname, code - Enters the user into the system and is his 
initial command. 'Projectname" is a name known to the systcm (introduced 
initially from a system command typewriter) and "code" is a password which 


must match the one stored for "projectname. "' 


getfilespacc number - Each user "owns" a certain amount of space 
for his files, which is the maximum number of words of files he may have. 
He initially starts out with no space, and this command adds "number" of 
4K blocks to the amount of space he owns, if there is enough space left in 
the system. No cffort is made to prevent knavery, but the amount of space 
the user has is always open for public inspection. 'Number'' may be any 


legal expression. 


giveupfilespace number (n) - Gives up n 4K blocks which the user 


Owns. 


createfile name (f), number (n) - Create a file named f having n 


4K blocks, if he has cnough unused space. 


destroyfile name (f) - Destroys file f , losing all information the 


file contained and freeing the space it occupied for his use. 


makepgm name (f) - Makes file f the user's current program file, 
and sets the live registers to standard values. File f now becomes the 


program's ''core registers" as described later. 


run - Causes the running of the current program, under the control 
of its live registers. While the program is running, any typed input, except 
an EOM (end of message) character, will be considered to belong to the 
program. The program will terminate when one of the following conditions 


arises: 


(1) supervisor terminate routine called, 
(2) program causes out-of-bounds condition, 
(3) EOM key hit on command typewriter, or 


(4) program file too long to fit in core. 
EOM 


The end-of-message character causes the current program to stop 
running. The live registers are saved so that typing the run command will 
cause it to continue from where it stopped. However, any contents of the 
typewriter's input buffer preceding the EOM, and not yet read by the pro- 


gram, will be destroyed. 


attach devicename (d), number (n), name (f) - D is the name of a 
device, n is a number from 3 to 15, and f is any legal symbol which is 
not already defined for the user (may be omitted). If the specified device 
is free, it is attached to the user as his device n. F is then defined to 


have the value n. 


detach number (n) - The device attached to the user as his number 


n is detached, and made free for use by someone else. 


connectfile file (£), arm (a) - Connects the file f to device number 


jp 


disconnectfile arm (a) - Disconnects the file from device number 2. 


setreg reg (r), value (v) - Sets live register r tv. 


panel - Prints out live registers. 


THE USER PROGRAM'S VIEW OF MONITOR 1 


The user's program has all of the features of PHOENIX operating in 
protected status. Since some of these features are of no value to the pro- 
gram, such as being able to read actual clock (CK) or interrupt register 
(nr), we define a pseudo-machine containing the useful features of the 


protected status of PHOENIX plus others provided by the Monitor. 


The user's pseudo-machine consists of a file (representing the pro- 


gram's core memory) and a set of live registers. The live registers are: 


1, PHOENIX registers AC, BR, CAR, CCAR, CCI, MC, MTC, 
PC, PCC, 3K1, ZR2, SRS, KRA, XRG; 
2. The user's interrupt register: nr} 


3. The user's interrupt disable bit: idb. 


The nr and idb are described below. 


THE INTERRUPT SYSTEM 


The user program has an interrupt register (nr) which is 24 bits 
long. Bit i of this register is set to 1 when an unmasked interrupt is 
generated by the user's device number i. This process will be explained 
later. If, at the completion of any machine instruction or Monitor service- 
routine, nr # 0 and the user's interrupt disable bit (idb) is 0, then an 
interrupt takes place, causing the following: 

1 — idb 
} =" a 


MC!3:5 +a] 3:5 


PCC —aj6 

CCI ~a}7 

PC —a]}8:23 
O—-b 

CCAR —b} 0:6 
effectiveaddress ([7] ) —i 
a — mem (i) 

b — mem (i+1) 
nr — mem (i+2) 
1— PCC 

0 -CAR 

0 — CCAR 

0 —- CCI 

0-—-nr 


§-- PC 


This procedure saves all the information normally saved by PHOENIX 
in an interrupt, plus nr, in the three memory words specified by the effec- 
tive address of memory location 7. This allows pure procedures to be run 
by more than one user at the same time. The program then continues, with 


interrupt disabled (idb = 1), from location 8. 


MONITOR COMMANDS 


Monitor commands are executed by performing a BCH with the appro- 
priate effective address. This address will depend upon the command, and 
will be a number between 2°6 and Z” and gif and 1 (in the upper 4K of 
the 64K possible addresses.) The ae argument of the command is obtained 
as follows (n=1, 2, ...). All live registers except PC are reset to their 
states after the BCH was performed. PC is set to n locations after the 
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BCH. The instruction at this location is performed, an interrupt taking 
place immediately after. The current contents of AC is then the mae argu- 


ment. 
End Command 


The end command terminates the running of the program, transfer- 
ring control to ALTAR which will type out the location of the command. 
The program's live registers will be saved by ALTAR so that the program 


may be allowed to continue running from the next location. 


Program Termination 


Any out-of-bounds memory reference, or attempted transfer of con- 
trol to an out-of-bounds address (other than by a legal monitor command 
BCH) will cause the program to halt just as by the execution of the end 


command, except that ALTAR will type an appropriate error indication. 
Enable Command 


This command has a single 16-bit argument. If interrupts are enabled 
([idb] = 0), then the command is a NOP. Otherwise, the live registers are 
restored in an inverse manner to their being saved by an interrupt, except 
that [ir] is unchanged; then interrupts are enabled (0 — [idb]) and XR5 is 


set equal to the argument given. (Note that contents of XR5 were changed 


by the BCH instruction used to call the enable command. ) 
Godorm Command 


This command puts the program in dormant status pending the arrival 
of aninterrupt. If the program is disabled when the godorm command is 
issued, then it will be enabled (as by an enable command) before going 


dormant. 


THE USER'S DEVICES 


The user has available to him up to 16 different devices, numbered 
from 0 to 15. Device numbers 0, 1, 2 have fixed significance, while 
device numbers 3 to 15 may be attached to devices arbitrarily, or left 


unattached. 


Device number 0 is unattached while the user program is running. 
Device number 1 is attached to the user program file arm, a file 
arm to which is connected the user program file. 
Device number 2 is attached to the command typewriter. 
Device numbers 3 to 15 each may be unattached, or attached to one 
of the following, if available: 
Paper Tape Reader 
Paper Tape Punch 
Digital Incremental Recorder (Plotter) 
Magnetic Tape Drive 


File Arm (see below). 
File Arms 


A file arm is a device used to communicate with a file. The file arm 
is connected to a specific file, and may be thought of as a spigot between 
the program and the file. There may be more than one file arm attached 
to a single file, which permits overlapping of several operations to that 
file. (Initially, as long as working files are all kept on the drum, this 


overlapping is mythical and will result in no saving of time. ) 


Device Registers 


Each device contains the following four registers. The exact meaning 
of the various bits of the registers will vary with the device, but there will 


be some standard ones. 


dir - device interrupt register - 12 bits - The bits of this register 


are set by interrupts generated by the device. Whenever a bit is set by an 
interrupt, for which the appropriate bit of the device mask register (dmr) 
equals zero, the = bit of the user's nr (interrupt register) is set to 1, 


where i is the device number. 


dmr - device mask register - 12 bits - A 1 ina position of this 
register prevents the corresponding bit of the dir from causing a pro- 


gram interrupt (setting nr). 


dsr - device status register - 12 bits - The bits of this register 


describe the status of the device (e.g. , busy, inoperative). 


dpr - device property register - 12 bits - The contents of this 
register describe properties of the device. For a typewriter, the dpr 


specifies the break character set for that device. 


The device registers can be read, and dir, dmr, and dpr be 


changed, using the doio (do input/output operation) command. 


THE DOIO COMMAND: DOIO (DV, OP, WC, MA, DVA, ER) 


This command is used to perform all input/output operations. It has 


the following arguments: 


1. device (dv) - The number (between 0 and 15) of the device. 

2. operation (op) - A 24-bit number specifying the operation. 
This number will be the same for similar operations performed 
on different devices (e.g. output characters to a typewriter or 
paper tape punch), but two different operations to different 
devices will not have the same operation name (e.g. read 


characters from typewriter, and rewind tape drive). 


3. word count (we) - A 16-bit number specifying the maximum 
number of words which may be transferred by the operation. 

4, memory address (ma) - The starting address in memory of the 
operation. 

5. device address (dva) - A number specifying an address within 
the device. 

6. exception return (er) - If, either because of illegality or other 
demands upon the system, the i/o operation is not attempted, 
control will be transferred to the location indicated by this 
argument. [XR5] will then contain the normal return address 
(location of the BCH + 7) and [AC] will indicate by a code 


number why the operation was not done. 


After execution of the doio command, control is returned to the pro- 
gram and the actual input/output proceeds in parallel. The progress of 
the i/o may be'checked by reading the device status and interrupt registers, 
or by waiting for an interrupt. Until the operation is finished, no other 
doio command may be given to that device except to read or set the 


device's registers. 


10 


SECTION III 
THE USER PROGRAM I/O 


DEVICE REGISTERS 


The following are the bits of the device registers which have a fairly 


uniform meaning for all devices. 
dir - device interrupt register 


bit 0 - mem free 
Set after a doio command when the transfer of information is 
complete so far as memory is concerned. I.e., on input, all 
information has been read into memory; on output, the memory 


area involved may now be changed without affecting the operation. 


bit 1 - device free 
Set after a doio command when the device becomes free to 
accept another command. This interrupt will never occur 


before the mem free interrupt (bit 0). 


bit 2 - inoperative 
Set when an operation initiated by a doio command cannot be 
successfully performed because the device is found to be 


inoperative. Bits 0 and 1 will be set when this occurs. 


bit 3 - device error 
Set after a doio command when an error has occurred in the 
operation. The interrupt will occur when the error is detected, 


but before the operation is completed. 
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dsr - device status register 


bit 0 - device busy 
This bit is set to 1 if and only if the device is busy performing 
an operation initiated by a doio command and is not free to 


perform another operation. 


bit 1 - device not ready 
This bit is set to 1 if the device is not ready to perform an I/O 
operation (not because of the execution of a doio command) but 
should become ready within some fixed time depending upon the 
device, e.g., termination of typewriter output with begin mes- 


sage key. 
dmr - device mask register 
Same as dir in meaning of bits. 
dpr - device property register - 12 bits 
An additional register, whose meaning (if any) varies with the 


device. It can be set by the program. 


GENERAL DOIO COMMAND OPERATIONS DOIO (DV, OP, WC, MA, 
DVA, ER) 


Certain operations (argument 2 of the doio command) apply to a large 


number of devices and are described below. 


doio operations 


Number Operation 
0 readregs 
1 setregs 
2 read 
3 write 


12 


Number Operation 


4 blankwrite 
5 endfile 
6 backspace 
7 rewind 
8 unload 
9 nop 
10 readwc 
dd setlength 
12 start 
13 stop 
14 readfileref 
15 connectfile 
16 disconnectfile 


read, write 


These are the common input and output operations. Their meanings 
will vary slightly with the device, and will be described fully for each 
device. In general, they cause the number of words specified by we 
(argument 3) to be read into or written from memory beginning at location 
ma (argument 4). If the device specified by dv is busy or not ready, the 
operation will not be attempted and a busy or not ready exception return to 


er will occur. (The exception return will be discussed later. ) 


read registers 


This operation reads the devices registers into memory at locations 


ma (argument 4) and ma + 1 in the following format: 


[dir] is set equal to zero. The operation will be performed even if the 


device is busy or not ready. 
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setregisters 


Or's [ma] 


[ma + 1] iene 


19.23 into dir and transfers [ma + 1] 


into dmr. 


0-11 into dpr and 


The operation will be performed even if the 


device is not ready. The nr (interrupt register) bit for the device will be 


set if dmr/ dir is zero before the transfer, and nonzero after. Exception: 


the following list gives the codes if the exception return is taken. 


Code Number 


0 


Meaning 


Operation not performed for miscellaneous rea- 
sons (e.g. attempt to write or set length of read- 
only file). 


Device number error. Device number is either 
not in the range 0 to 15, or is unattached. 


Device busy or not ready. The operation requires 
the device to be idle or ready, but it is not. 


Memory bounds violation. The operation, if per- 
formed, would apparently result in data transfer 

to or from an out-of-bounds location, i.e., ma not 
in the range of 0 to 216-1, or ma + we > length of 
program. 


Illegal operation. The operation requested is not 
legal for the specified device. (0 = op = maxop 
test for all ops). 


Bad device address. The device address specified 
is negative, or would cause trouble. E. g., for file 
read or write, dva +we > length of file. 


Bad word count. we not in the range 0 to 218 (all 
ops), or we cannot be allowed for the operation, 
for some reason other than a memory bounds 
violation or a bad device address. E. g., for 


readregs, setregs, we < 2. 


14 


Code Number Meanin 


1 Bad device condition (not covered in 2). 
8 Pup busy. 
9 Stack full. 
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SECTION IV 
TYPEWRITERS 


Typewriter input and output (ICS characters) is buffered inside the 
Monitor. The typewriters are normally in input mode, ready for type-in. 


The typewriter keyboard will be locked if: 


(a) the typewriter is in output mode (typing out); 
(b) the buffer is full -- usually because the program to which the 
typewriter is attached has been ignoring it; 


(c) the LSB buffer has filled. 


Since the typewriters are in single-character mode and typewriter 
processing is done rapidly as the highest priority task of the Monitor, (c) 


should not occur. 


The user can always break through a hangup to get connected to 
ALTAR, since hitting the begin-message key will unlock the keyboard, 
leaving the typewriter in input mode with a clean buffer and unable to type 
out for a short time, and hitting the end-message key will connect the 


typewriter to ALTAR. 


REGISTERS 


The meanings of the bit positions of the typewriter registers are 
indicated below. These meanings will become clear when the operations 


are explained. 
dir, dmr 
bit 0 - mem free 


Unused. 
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bit 1 - device free 


Typeout complete or not ready period finished. 


bit 2 - device inoperative 
Typewriter discovered to be inoperative during typeout. 


bit 3 - device error 


Transmission error occurred during typeout. 


bit 4 - terminated 

Begin-Message key struck during typeout. 
bit 5 

Unused. 


bit 6 - attention 


Break characters typed in. 


bit 7 - bufferbell 


Input buffer near full, or output buffer near empty. 


bit 8 - inputerror 


Transmission error occurred during typein. 


bit 9 - buffercleared 
Buffer cleared in response to begin-message key being struck 


with full input buffer, or for output. 


bit 10 


Unused. 


bit 11 - eomcond 


eom character typed in. 
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dsr 


bit 0 - devicebusy 
Typing out in progress (= output mode). 


bit 1 - devicenotready 
Set for time tdelay after the typist has manually terminated 


output. 


bit 2 - bufferfull 


Set while the input buffer is full (more than nmarg characters). 


bit 3 - bufferlow 
Set while the input (output) buffer has fewer than inbell (outbell) 


characters in it. 
dpr - specifies break character set 
Consider the following character classes: 


num - digits 0 through 9 


le - lower case letters a through z 

uc - upper case letters A through Z 

pne - punctuation: . ,:; ? 

op. - other printing characters: < >! | / \—+ + +- * 
=#§T 1" “#1. 

cr -@ 

os - other spacing characters: 0 <4 J 

on - other nonprinting characters: ro) - {error} {illegal} 
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dpr bit class 


non-num 
non-le 
non-uc 
non-op 
non-pne 
non-os 
non-on 


aouhPWN Fe O&O 


A character is a break character if and only if it belongs to all 


classes for which the corresponding dpr-bit is a one. 


dpr bits set to 1 break class 

none all characters 

0 nonnumeric 

0,1 nonalphanumeric and upper case 
0,4,2 nonalphanumeric 

0; 15 4;3 nonprinting and punctuation 

0,1, 2,3,4 nonprinting 

0,1, 2,3,4,5 “” {YP (error) (illegal) 

0,1, 2,3,4,5,6 wy, 


TYPEWRITER I/O 


The typewriter doio operations are readregs, setreys, read, write. 
The monitor maintains for each typewriter a buffer having the capacity to 
hold beap characters. At any moment, the typewriter is in one of two 


modes: input or output. 


Input Mode 


The typewriter keyboard is normally unlocked; it will be locked if 
the buffer is full. 


Each character typed is entered in the buffer. It will be replaced by 
a special error character if a transmission error occurred. In this case, 
the typewriter's inputerror interrupt will be set. 
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If the character is a break character, as defined by dpr, then the 


typewriter's attention interrupt is set. 


If the character is an EOM character, then the eomcond interrupt 
will be set both for the typewriter and for its job's program file arm. In 
addition, the buffer is reset, and the program terminated, connecting the 


typewriter to ALTAR. 


If the character is the inbell-th in the buffer, then bufferbell interrupt 


is set, and bufferlow status is cleared. 


If the character is the nmargin-th in the buffer, then set bufferball 
status and lock the keyboard. Characters typed in while the keyboard is 
being locked may be lost. 


If the begin-message key is struck while the typewriter is in input 


mode and the buffer is full, then the following events take place: 


(1) clear input buffer; 
(2) unlock keyboard; 
(3) clear device bufferfull status bit; and 


(4) set device buffercleared interrupt bit. 


Output Mode 


The typewriter keyboard is locked. Characters are typed out from 
the buffer. When the outbell-th character is typed out, bufferbell interrupt 


bit is set. 


If the buffer becomes empty, and all characters have actually been 
typed out, then: 
(1) setdevice devicefree interrupt bit; 


(2) clear device devicebusy status bit; and 
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(3) set typewriter to input mode, with an empty input buffer, and 


an unlocked keyboard. 


If the begin-message key is struck while the typewriter is in output 


mode, then: 


(1) clear output buffer and terminate typeout; 

(2) set device terminated interrupt bit; 

(3) set device devicenotready status, leaving it set for tdelay 
seconds; 

(4) clear device devicebusy status bit; and 

(5) set typewriter to input mode, with an empty input buffer, and 


an unlocked keyboard. 


Bufferlow status bit is on when output buffer has no more than 


outbell characters in it. 


Transmission Errors 


If a transmission error occurs, device interrupt bit error or input- 
error will be set, according as the typewriter is in output mode or input 


mode. This depends on which mode the typewriter is in, output or input. 


Inoperative 


If the typewriter proves inoperative during typeout, then: 

(1) clear output buffer and terminate output, 

(2) set deviceinoperative interrupt bit; 

(3) clear devicebusy status bit; and 

(4) set typewriter to input mode, with an empty input buffer, and 


an unlocked keyboard. 
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TYPEWRITER CHARACTER TRANSMISSION OPERATIONS 


The doio operations getchars, putchars are character-oriented 
routines used to transmit strings of characters to and from the Monitor 


typewriter buffers. 


These commands operate on a character basis rather than a word 
basis; as opposed to word location -- a 16-bit quantity specifying the 
location in memory of a 24-bit word, the commands require the concept 
of a character-location -- an 18-bit quantity specifying the location in 
memory of an 8-bit character. The commands require the concept of a 
character location rather than that of a word location. A word location 
is a 16-bit quantity specifying the location in memory of a 24-bit word; a 
character is an 18-bit quantity specifying the location in memory of an 


8-bit character. A character-location has the following format: 


where 1 = ca = 3. This character-location specifies character number 


ca of the word at location wa: 


getchars command - doio(d, read, Po Py» ex) =p 


Normal Case: d is the device number of a typewriter. Characters 
from the typewriter buffer are transmitted to character-locations 
Por sees until either: 

(1) A break character is transmitted; or 

(2) All characters in the buffer are transmitted; or 


(3) A character has been transmitted to the character-location just 
before pj. 
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Getchars then returns with value the character-location one beyond 
that of the last character transmitted. The characters transmitted are 


deleted from the Monitor buffer. 


For abnormal cases the location of the normal return is put in XR5, 


an exception code is put in the AC, and control is transferred to location 


ex. 
Code Number Meaning 
0 Typewriter buffer is empty 
1 Device number d is either not in the range 0 
to 15, or it is unattached 
2 Typewriter is busy 
3 Memory bounds violation. Locations 
Po-++»Py_ 7 are not all in bounds 
4 Specified device is not a typewriter 
5 Character address of Po or P, ig not 1, 2, or 3, 
putchars command - doio (d, write, Po >» Pye ex) = p 
Normal Case: d is the device number of a typewriter. Characters 
in character-locations Po: ... are transmitted to the typewriter buffer 


until either: 


(1) The character in location Pia has been transmitted; or 


(2) The Monitor buffer fills. 


Putchars then returns with value the character-location one beyond 


that of the last character transmitted. 


Abnormal Cases: In case of an exception, the location of the normal 
return is put in XR5, an exception code is put in the AC, and control is 


transferred to location ex. 
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Code Number Meaning 
0 Typewriter buffer is full 


1 Device number d is either not in the range 0 
to 15, or it is unattached 


2 Typewriter is not ready 
3 Memory bounds violation. Locations 
Po>+++»Py_q are not all in bounds 
4 Specified device is not a typewriter 
5 Character address of Pp OF Py is not 1, 2, or3. 
CONSTANTS 
beap 156 characters 
inbell 130 characters 
nmarg 153 characters 
outbell 50 characters 
tdelay 0.5 second 
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SECTION V 
FILES AND FILE ARMS 


In general, the user has several files, i.e. , ordered collection of 
data, available for his use. A program operates on a file by having a 


device called a file arm attached to itself, and connected to the file. 


The user attaches a file arm to his program as a device numbered 


3 to 15 using an appropriate ALTAR command. 


A file arm may be connected to a file by the user, through typing an 


ALTAR command or by the program itself. 


The user program may only read, write or otherwise interrogate 
file through file arms which have been so attached, and can refer to them 
only by device number. The user may have files which are not connected 
to file arms. Any file may be run as the program file by being connected 
to device number 1: the program file arm. A file may be attached to the 
job through more than one file arm. Each file arm will have a separate 
independent set of device registers. The file may be operated on through 
one file arm, even if it is busy under another. Each file arm to which the 
file is attached thus acts as a separate data channel to the file, allowing 
parallel operation. In Monitor 1.0, this parallel operation is merely an 


illusion and no overlapping of the operations will actually be done. 


When active files are kept on a disk, in future systems, overlapping 


may be done. 
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REGISTERS 


dir, dmr - device interrupt and mask registers 
bit 0 - memoryfree 
Set by a read or write operation when the data transfer is 
completed. 
bit 1 - devicefree 
Set at the same time as the memoryfree interrupt bit. 
bit2 - 11 
Unused. 
dsr - device status register 
bit 0 - devicebusy 
Equals 1 when a read or write operation is in progress. 
dpr - device property register 


Unused. 


FILE ARM I/O OPERATIONS 


User programs use file arms to manipulate files using the doio 

routine. The format of the doio call is: 
doio(dv, op, wc, ma, dva, er) 

where 

dv is one of the job's device numbers, to which a file arm is 
attached. 

op is one of the operations readregs, setregs, readfileref, read, 
write, setlength, connectfile, or disconnectfile. 

we is the word count. 


ma is the memory address. 
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dva is the starting address within the file (first word of file is at 


address zero). 


er is the exception return location. 


Recall that for each job, devices numbered 0, 1, and 2 have special 
significance: 

Device 0 is unattached. 

Device 1 is attached to a file arm to which the user program file is 
connected. 


Device 2 is attached to the command typewriter. 


readregs 


Normal Case: The two device registers associated with the given file 
arm are loaded into memory, locations ma and ma + 1, and the device inter- 


rupt register is cleared: 


setregs 
Normal Case: Or [ma] J 12:23 into dir; load dvr2 from ma +1; 
if dmr and dir were zero before the change, and become nonzero after it, 


then set pir} dv to one, and interrupt. 
readfileref 


Normal Case: The file number of the file connected to the file arm 


is stored at location ma in the format: 


ei 


17 23 
po | te 


Exceptions: 


4 The device attached to dv is not a file arm. 


7 No file connected to the file arm. 


read 
Normal Case: I/O operations are initiated to transfer we words 
from the file to the program. Starting location in the file is dva and in 


the program is ma. 


write 
Normal Case: I/O operations are initiated to transfer we words 
from the program to the file. Starting location in the program is ma and 


in the file is dva. 


setlength 
Normal Case: The number of 4K blocks of the file attached to the 


specified file arm is set to one more than the greatest multiple of 4K not 
greater than dva. 
This operation generates no interrupts and is executed immediately, 


even if the device is busy. 


connect file 


Normal Case: The file whose reference number is dva is connected 


to the file arm attached to dv. 
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disconnectfile 
Normal Case: The file (if any) connected to the file arm attached to 


dv is disconnected from it. 


EXCEPTION CODES FOR FILE ARM DOIO 
doio(dn, op, we, ma, dva, er), where op is one of readregs, setregs, 


readfileref, read, write, setlength, connectfile, or disconnectfile. 


Code Number Meaning 


0 File is read-only (write, setlength). File not 
available to job (connectfile). Cannot disconnect 
program file (disconnectfile). 


ni Device number dn is either not in the range 0 
to 15, or it is unattached. 


2 File arm is busy (read, write, disconnectfile). 


3 Memory bounds violation: ma not in the range 
0 to 64K-l or ma + we > length of program. 


4 Illegal operation for file arm. 


5 Bad device address: dva < 0, or dva+ we > length 
of file (read, write), or not enough unused file space 
(setlength), or dva not a legal file number (connect- 


file). 

6 Bad word count: we not in the range 0 to yg » OF 
we < 2 (readregs, setregs). 

7 Bad device condition: file arm not connected to a 


file (read, write, setlength), or file arm already 
connected to a file (connectfile). 


8 Some tape-drive or file arm attached to this job is 
busy with data transmission (read, write). 


9 Cannot stack (read, write). 
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SECTION VI 
TAPE- DRIVE 


The doio operations for a tape-drive are readregs, setregs, read, 


write, backspace, rewind, unload, endfile, blankwrite, readwc, and nop. 


Read, write, and blankwrite are data operations. Readregs, setregs, 


backspace, rewind, unload, endfile, readwc, and nop are nondata operations. 


dir, dmr 
bit 0 - memory free 


bit 1 


bit 2 


bit 3 


Set by data operations (ops) when information transfer is 


complete as far as central memory is concerned. 


- device free 
Set when tape-drive is free to accept another command. This 


will never occur before memory free is set (read, write, 


blankwrite). 


- inoperative 


Set when a tape operation cannot be successfully performed 


because the drive is found to be inoperative. 


- rwerr 
Read/write error has occurred during tape operation. Set 
when error is detected, but before operation is completed 


(read, write, blankwrite, or endfile). 
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bit 4 - exception 


Unusual condition has arisen during tape operation. 


read ~ 
write - 
blankwrite - 


endfile - 


bit 5 - abort 


End-of-file (EOF) passed. 
End-of-tape condition during operation. 
End-of-tape condition during operation. 


End-of-tape condition during operation. 


Tape Control Unit (TCU) operation was aborted: TCU busy 


too long. 


bit 6 - rewind complete 


Tape reel has reached load point. 


dsr 


bit 0 - device busy 


Tape drive is busy. 


bit 1 - ready read 


Tape drive not busy and ready for reading. 


bit 2 - ready write 


Tape drive not busy and ready for writing. 


bit 3 - load point 


Tape drive at load point. 


readcount 


Status informa- 
tion about tape 
as of last device 
free or rewind 


complete inter- 
rupt in doio. 


Register containing the number of words read by a read operation. 
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TAPE DRIVE OPERATIONS 
doio (dv, op, we, ma, den, er). Den specifies density: 0 = 556 bpi; 
2 = 800 bpi; other = illegal. 

read 

Ls If any exceptions occur, the operation is not attempted 
(return to er). 

2. Set device busy status. Set up status bits 1, 2, 3. 

3. Stack the operation and return. At some later time, the 
operation will actually be attempted. 

4. If the drive proves inoperative or "busy" then set inoperative 
and return free interrupts, set readcount to zero, and go to 
step 6. 

5 Read words from the tape at specified density and transmit, 
with zero metabits, to central memory locations ma onward, 
until data transmission is finished. 

6. Get readcount to show the actual number of words transmitted 
and set memory free interrupt. 

hes When the tape drive becomes idle, set the following interrupts 


and status bits: 


device free error - if a redundancy error occurred. 
exception - if EOF condition occurred. 
device busy - set to 0. 


dsr lists 1, 2, 3 


set to one or zero if the tape drive is 
ready for reading or not, ready for 
writing or not, at load point or not, 


respectively. 
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write, blankwrite 


(2) 


(2) 
(3) 


(4) 


(5) 


(6) 
(7) 


If any exceptions occur, the operation is not attempted 
(return to er). 

Set device busy status. Set up status bits 1, 2, 3. 

Stack the operation and return. At some later time, the 
operation will actually be attempted. 

If the drive is inoperative or busy then set inoperative 

and memory free interrupts and go to step 6. 

If the op is blankwrite then write a blank space on tape. 
Obtain we words from central memory locations ma onward, 
and write (ignoring metabits) on tape at the specified density. 
Set memory free interrupt. 

When the tape drive becomes idle, set the following interrupt 


and status bits. 


device free error - if a redundancy error occurred. 
exception - if end-of-tape condition occurred. 
device busy = set to 0. 

status 1, 2,. 8 - set appropriately. 


backspace, endfile, nop 


(1) 


(2) 
(3) 


If any exceptions occur, the operation is not attempted 
(return to er). 

Set device busy status. Set up status bits 1, 2, 3. 

Stack the operation and return. At some later time, the 


operation will actually be attempted. 
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(4) If ihe drive is inoperative or busy then set inoperative inter- 
rupt and go to step 6. 

(5) Perform the specified action: 
backspace - move the tape backward until either one record 


is passed or the load point is encountered. 


endfile - write EOF on the tape in the specified density. 
nop - no action. 


(6) When the device becomes idle, set the following interrupt and 


status bits: 


device free error - if a redundancy error occurred (endfile). 

exception ~- if an end-of-tape condition occurred 
(endfile). 

device busy - set to zero. 

status 1, 2, 3 - set appropriately 


rewind, unload 

(1) If any exceptions occur, the operation is not attempted 
(return to er). 

(2) Set device busy status. Set up status bits 1, 2, 3. 

(3) Stack the operation and return. At some later time, the 
operation will actually be attempted. 

(4) If the drive proves inoperative or busy then set inoperative 
interrupt and go to step 6. 

(5) Move the tape backward to load point. If the operation is 


unload, then unload it. 
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(6) | When the device becomes idle, set the following interrupt and 
status bits: 


device free 


rewind complete 


device busy - set to 0. 
status 1, 2, 38 - set appropriately. 
readwe 


(1) If any exceptions occur, the operation is not attempted 
(return to er). 


(2) Return with value readcount. 


EXCEPTIONS 


Code Numbers 


0 Some tape drive attached to job is busy with 
a non-data op. * 


1 Device number error: device number dv is 
either not in the range 0 to 15 or is unattached. 


2 Device busy or not ready for the specified 
operation. * 


3 Memory bounds violation: ma not in the range 
0 to 64K-1, or ma + we > length or program. 

4 Illegal operation: op not legal for tape drive, 

5 Illegal density, den not 0 or 2. 

6 Bad word count: either we not in the range 0 to 


218 or we < 2 for readregs or setregs. 


* 
dsr readyread, readywrite, and loadpoint already updated. 
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Code Number 
T Does not apply. 


8 Some tape drive or file arm attached to this job 
is busy with data transmission. * 


9 Cannot stack the operation. * 


* 
dsr readyread, readywrite, and loadpoint already updated. 
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SECTION VII 
PAPER TAPE READER (RDR) 


The doio operations for the reader are readregs, setregs, start, 
read, stop. 

The monitor maintains a buffer inside the Monitor for the RDR, as 
well as an LSB buffer. 

Start specifies the size of the LSB buffer (gulpsize) and begins input 
from RDR. 

Read transmits characters from the Monitor buffer to the program. 


Stop arranges to terminate input from RDR. 


REGISTERS 
dir, dmr 
0 
1 device free - RDR input activity terminated. 
2 inoperative - RDR discovered to be inoperative or faulty 


(not transmission error), 
error - transmission error occurred during input. 
does not apply. 
does not apply. 


3 

4 

5) 

6 does not apply. 
G attention - buffer contains at least one gulp. 
8 does not apply. 

9 does not apply. 

10 does not apply. 


nia does not apply. 
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Q 
wn 
Ky 


0 device busy - 
1 does not apply 
2 buffer full. 
3 buffer empty. 
4 stop read - 
5) does not apply. 
6 does not apply. 
7 does not apply. 
8 does not apply. 
9 does not apply. 
10 does not apply, 
11 milz. 
dpr 
Unused. 
RDR 1/O 


RDR actively inputting. 


terminate RDR activity as soon as possible. 


This condition obtains while the RDR is actively inputting. The 


input operation terminates either by filling the LSB RDR buffer, or as a 


result of a stop doio turning off the RDR Input Status indicator. 


0-— dis} rdn 
Unload LSB RDR input buffer. If RDR proves inoperative, 


(1) 


(2) 


then set the inoperative and device free interrupts, clear 


Transfer the unloaded data (if any) to the RDR Monitor buffer. 


device busy status, and omit the remaining steps. 
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(3) 


(4) 


start 


If any data was transmitted, then 


a. If buffer empty status is on, turn it off and set 
attention interrupt. 


b. If there is too little room in the Monitor buffer to 
accommodate another gulp, set bufferfull status. 


If either bufferfull status or stop read status is on, then 
set device free interrupt and clear device busy status. 
Otherwise re-initiate input activity, inhibiting lead zeros 
if milz = 1, Clear milz. If RDR now proves inoperative, 


then set inoperative and device free interrupts, and clear 


device busy status, otherwise 1 — dis ) rdr. 


doio(ptr, start, gulpsize, ilz, , er) 


(1) 
(2) 
(3) 


(4) 
(5) 
(6) 
(7) 


read 


If device busy status on, then exception 2. 

If gulpsize > maxgulpsize then exception 6, 

If gulpsize < 0 then let gulp = standard gulpsize, otherwise 

let gulp = gulpsize. Set the LSB input buffer for RDR to have 
length gulp words. 

Clear the Monitor buffer for RDR. 

Clear bufferfull and stopread status. Set bufferempty status. 
Arrange to initiate RDR input (after which milz will be cleared). 


Return with value = gulp. 


doio(ptr, read, we, ma, , er) 


(1) 
(2) 


If ma + we is out of bounds then exception 3 results, 


Let bwe be the number of words in the Monitor RDR buffer, 
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(3) 


(4) 


(5) 
(6) 


stop 


and let twe = min(bwe, we). Transmit the first twe words from 

the buffer to ma,...,ma = twe-1. 

Delete the first twe words from the buffer. Let bwel be the 

number of words now remaining in the buffer: bwel = bwe - twe. 

If bufferfull status is on, and there is room in the buffer for a 

gulp (i.e. , bwel + gulp + 1 < buffer size) then 

a. Clear bufferfull status. 

b, If stop read status is off, then arrange to initiate RDR 
activity. 

If bwel = 0, then set bufferempty status on. 


Return with value twe, the number of words transmitted. 


doio(ptr, stop, ,,, er) 


L, 
Qe 


Set stopread status. 
If device busy status is on, then arrange to terminate RDR 


activity. 


NOMINAL VALUES OF CONSTANTS 


maxgulpsize - the largest admissible size for LSB RDR buffer 


(192 words). 


standard gulpsize - the standard value for LSB RDR buffer 


(192 words). 


buffer size - the size of the Monitor RDR buffer (400 words), 
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EXCEPTIONS FOR READER 


doio(dv, op, wc, ma, dva, er) 


op = read, start, stop, readregs, setregs 


i. 


Device number error. Either dv not in the range 0 to 15 or 
dv is unattached. 

Device busy (start). 

Memory bounds violation. ma not in the range 0 to 64K-1 
or ma+ we > length of program. 

Illegal operation. op not in the range 0 to maxop, or op not 
legal for RDR. 

Bad device address. dva < 0. 

Bad word count. we not in the range 0 to "had , OF Wa < 2 


(readregs, setregs), or wc > maxgulpsize (start). 
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SECTION VIII 
PAPER TAPE PUNCH 


The doio operations for the punch are readregs, setregs, and write. 
The Monitor maintains a buffer of bcap words for the punch, from 
which characters are punched. The buffer is loaded using a write command, 


and is unloaded automatically as long as the buffer is not empty. 


DEVICE REGISTERS 


dir, dmr 

1 device free - buffer empty and punch idle. 

2 inoperative - punch discovered to be inoperative during punch 
out. 

3 error - transmission error punching characters. 

7  bufferbell - bufferlow status has been set during punch out. 

dsr 

0 device busy - punching out in progress. 

1 bufferlow - buffer contains no more than bell words. 


TRANSMISSION ERRORS 
If a transmission error occurs while the punch is busy, then the 


error interrupt bit is set. 


INOPERATIVE 
If the punch proves inoperative during punch out, then the buffer is 


cleared, the inoperative interrupt is set, and the status bits are reset. 
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WRITE OPERATIONS 


The write operation is doio(pch, write, we, ma, , er) 


(1) 


(2) 


(3) 


(4) 
(5) 


CONSTANTS 


Let there be bleft words in the Monitor punch buffer. 

Let wwe = min(we, bleft). Transmit wwe words to the punch 
buffer from ma,..., max + wwe-l, 

If the buffer is not empty, then set device busy status. 

If the buffer contains no fewer than bell words, clear 
bufferlow status. 

If the buffer is not empty, arrange to punch out its contents. 


Return with value wwc, the number of words transmittted. 


beap - 100 words 


bell - 50 words 


EXCEPTION CODES 


op = write, readregs, setregs. 


nl 


Device number error. Either dv not in the range 0 to 15 
or dv is unattached. 

Memory bounds violation. ma not in the range 0 to 64K-1 
or ma+ we > length of program. 

Illegal operation. op not in the range 0 to maxop, or op 
not legal for PCH. 

Bad device address. dva < 0. 

Bad word count. we not in the range 0 to 28 » OF We < 2 


(readregs, setregs). 
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SECTION Ix 
PLOTTER 


The doio operations for the plotter are readregs, setregs, and 
The Monitor maintains a buffer of beap words for the plotter, from 
which data is sent to the lob to be plotted. The buffer is loaded using a 


write command, and is unloaded automatically as long as it is not empty. 


DEVICE REGISTERS 
dir, dmr 


iL device free - buffer empty and plotter idle. 


2 inoperative - plotter discovered to be inoperative during output. 
3 error - transmission error plotting points. 

7 bufferbell - bufferlow status has been set during plotter output. 
dsr 

0 device busy- plotting in progress. 

1 bufferlow - buffer contains no more than bell words. 


TRANSMISSION ERRORS 


If a transmission error occurs while the plotter is busy, then the 


error interrupt bit is set. 


INOPERATIVE 


If the plotter proves inoperative during output, then the buffer is 


cleared, the inoperative interrupt is set, and the status bits are reset. 
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WRITE OPERATION 


doio(plotter, write, we, ma, , er) 


1 


CONSTANTS 


Let there be bleft words in the plotter buffer. Let 

wwe = min(we, bleft). Transmit wwe words to the plotter 
buffer from ma,...,ma+ wwe-l. 

If the buffer is not empty, then set devicebusy status. 


If the buffer contains no fewer than bell words, then clear 


bufferlow status. 


If the buffer is not empty, arrange to plot its contents. 


Return with value wwe, the number of words transmitted. 


beap - 300 words 


bell 


- 150 words 


EXCEPTION CODES 


doio(dev, op, we, ma, dva, er) 


op = write, readregs, setregs. 


1 


Device number error. Either dv not in the range 0 to 15 
or dv is unattached. 

Memory bounds violation. ma not in the range 0 to 64K-1 
or ma + we > length of program. 

Illegal operation. op not in the range 0 to maxop, or 


op not legal for PCH. 
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Bad device address. dva < 0. 
Bad word count. we not in the range 0 to 2* ; OF 


we < 2 (readregs, setregs). 
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